<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD><TITLE>ttk::label manual page - Tk Themed Widget</TITLE>
<link rel="stylesheet" href="../docs.css" type="text/css" media="all">
</HEAD>
<BODY><H2><a href="../contents.htm">Tcl8.6.11/Tk8.6.11 Documentation</a> <small>&gt;</small> <a href="contents.htm">Tk Commands</a> <small>&gt;</small> ttk_label</H2>
<H3><A HREF="../UserCmd/contents.htm">Tcl/Tk Applications</A> | <A HREF="../TclCmd/contents.htm">Tcl Commands</A> | <A HREF="../TkCmd/contents.htm">Tk Commands</A> | <A HREF="../ItclCmd/contents.htm">[incr Tcl] Package Commands</A> | <A HREF="../SqliteCmd/contents.htm">SQLite3 Package Commands</A> | <A HREF="../TdbcCmd/contents.htm">TDBC Package Commands</A> | <A HREF="../TdbcmysqlCmd/contents.htm">tdbc::mysql Package Commands</A> | <A HREF="../TdbcodbcCmd/contents.htm">tdbc::odbc Package Commands</A> | <A HREF="../TdbcpostgresCmd/contents.htm">tdbc::postgres Package Commands</A> | <A HREF="../TdbcsqliteCmd/contents.htm">tdbc::sqlite3 Package Commands</A> | <A HREF="../ThreadCmd/contents.htm">Thread Package Commands</A> | <A HREF="../TclLib/contents.htm">Tcl C API</A> | <A HREF="../TkLib/contents.htm">Tk C API</A> | <A HREF="../ItclLib/contents.htm">[incr Tcl] Package C API</A> | <A HREF="../TdbcLib/contents.htm">TDBC Package C API</A></H3>
<DL>
<DD><A HREF="ttk_label.htm#M2" NAME="L1911">NAME</A>
<DL><DD>ttk::label &mdash; Display a text string and/or image</DD></DL>
<DD><A HREF="ttk_label.htm#M3" NAME="L1912">SYNOPSIS</A>
<DL>
</DL>
<DD><A HREF="ttk_label.htm#M4" NAME="L1913">DESCRIPTION</A>
<DD><A HREF="ttk_label.htm#M5" NAME="L1914">STANDARD OPTIONS</A>
<DL>
<DD><A HREF="ttk_widget.htm#M-class">-class, undefined, undefined</A>
<DD><A HREF="ttk_widget.htm#M-compound">-compound, compound, Compound</A>
<DD><A HREF="ttk_widget.htm#M-cursor">-cursor, cursor, Cursor</A>
<DD><A HREF="ttk_widget.htm#M-image">-image, image, Image</A>
<DD><A HREF="ttk_widget.htm#M-padding">-padding, padding, Padding</A>
<DD><A HREF="ttk_widget.htm#M-state">-state, state, State</A>
<DD><A HREF="ttk_widget.htm#M-style">-style, style, Style</A>
<DD><A HREF="ttk_widget.htm#M-takefocus">-takefocus, takeFocus, TakeFocus</A>
<DD><A HREF="ttk_widget.htm#M-text">-text, text, Text</A>
<DD><A HREF="ttk_widget.htm#M-textvariable">-textvariable, textVariable, Variable</A>
<DD><A HREF="ttk_widget.htm#M-underline">-underline, underline, Underline</A>
<DD><A HREF="ttk_widget.htm#M-width">-width, width, Width</A>
</DL>
<DD><A HREF="ttk_label.htm#M6" NAME="L1915">WIDGET-SPECIFIC OPTIONS</A>
<DL>
<DD><A HREF="ttk_label.htm#M7" NAME="L1916">-anchor, anchor, Anchor</A>
<DD><A HREF="ttk_label.htm#M8" NAME="L1917">-background, frameColor, FrameColor</A>
<DD><A HREF="ttk_label.htm#M9" NAME="L1918">-font, font, Font</A>
<DD><A HREF="ttk_label.htm#M10" NAME="L1919">-foreground, textColor, TextColor</A>
<DD><A HREF="ttk_label.htm#M11" NAME="L1920">-justify, justify, Justify</A>
<DD><A HREF="ttk_label.htm#M12" NAME="L1921">-relief, relief, Relief</A>
<DD><A HREF="ttk_label.htm#M13" NAME="L1922">-wraplength, wrapLength, WrapLength</A>
</DL>
<DD><A HREF="ttk_label.htm#M14" NAME="L1923">WIDGET COMMAND</A>
<DD><A HREF="ttk_label.htm#M15" NAME="L1924">STYLING OPTIONS</A>
<DD><A HREF="ttk_label.htm#M16" NAME="L1925">SEE ALSO</A>
</DL>
<H3><A NAME="M2">NAME</A></H3>
ttk::label &mdash; Display a text string and/or image
<H3><A NAME="M3">SYNOPSIS</A></H3>
<B>ttk::label</B> <I>pathName </I>?<I>options</I>?<BR>
<H3><A NAME="M4">DESCRIPTION</A></H3>
A <B>ttk::label</B> widget displays a textual label and/or image.
The label may be linked to a Tcl variable
to automatically change the displayed text.
<H3><A NAME="M5">STANDARD OPTIONS</A></H3>
<DL>
<DT><B><A HREF="ttk_widget.htm#M-class">-class, undefined, undefined</A></B>
<DT><B><A HREF="ttk_widget.htm#M-compound">-compound, compound, Compound</A></B>
<DT><B><A HREF="ttk_widget.htm#M-cursor">-cursor, cursor, Cursor</A></B>
<DT><B><A HREF="ttk_widget.htm#M-image">-image, image, Image</A></B>
<DT><B><A HREF="ttk_widget.htm#M-padding">-padding, padding, Padding</A></B>
<DT><B><A HREF="ttk_widget.htm#M-state">-state, state, State</A></B>
<DT><B><A HREF="ttk_widget.htm#M-style">-style, style, Style</A></B>
<DT><B><A HREF="ttk_widget.htm#M-takefocus">-takefocus, takeFocus, TakeFocus</A></B>
<DT><B><A HREF="ttk_widget.htm#M-text">-text, text, Text</A></B>
<DT><B><A HREF="ttk_widget.htm#M-textvariable">-textvariable, textVariable, Variable</A></B>
<DT><B><A HREF="ttk_widget.htm#M-underline">-underline, underline, Underline</A></B>
<DT><B><A HREF="ttk_widget.htm#M-width">-width, width, Width</A></B>
</DL>
<H3><A NAME="M6">WIDGET-SPECIFIC OPTIONS</A></H3>
<DL>
<DT>Command-Line Name: <B><A NAME="M7">-anchor</A></B>
<DT>Database Name: <B>anchor</B>
<DT>Database Class: <B>Anchor</B>
<DD>Specifies how the information in the widget is positioned
relative to the inner margins.  Legal values are
<B>n</B>, <B>ne</B>, <B>e</B>, <B>se</B>,
<B>s</B>, <B>sw</B>, <B>w</B>, <B>nw</B>, and <B>center</B>.
See also <B>-justify</B>.
<P><DT>Command-Line Name: <B><A NAME="M8">-background</A></B>
<DT>Database Name: <B>frameColor</B>
<DT>Database Class: <B>FrameColor</B>
<DD>The widget's background color.
If unspecified, the theme default is used.
<P><DT>Command-Line Name: <B><A NAME="M9">-font</A></B>
<DT>Database Name: <B>font</B>
<DT>Database Class: <B>Font</B>
<DD>Font to use for label text.
<P><DT>Command-Line Name: <B><A NAME="M10">-foreground</A></B>
<DT>Database Name: <B>textColor</B>
<DT>Database Class: <B>TextColor</B>
<DD>The widget's foreground color.
If unspecified, the theme default is used.
<P><DT>Command-Line Name: <B><A NAME="M11">-justify</A></B>
<DT>Database Name: <B>justify</B>
<DT>Database Class: <B>Justify</B>
<DD>If there are multiple lines of text, specifies how
the lines are laid out relative to one another.
One of <B>left</B>, <B>center</B>, or <B>right</B>.
See also <B>-anchor</B>.
<P><DT>Command-Line Name: <B><A NAME="M12">-relief</A></B>
<DT>Database Name: <B>relief</B>
<DT>Database Class: <B>Relief</B>
<DD>Specifies the 3-D effect desired for the widget border.
Valid values are
<B>flat</B>, <B>groove</B>, <B>raised</B>, <B>ridge</B>, <B>solid</B>,
and <B>sunken</B>.
<P><DT>Command-Line Name: <B><A NAME="M13">-wraplength</A></B>
<DT>Database Name: <B>wrapLength</B>
<DT>Database Class: <B>WrapLength</B>
<DD>Specifies the maximum line length (in pixels).
If this option is less than or equal to zero,
then automatic wrapping is not performed; otherwise
the text is split into lines such that no line is longer
than the specified value.
</DL>
<H3><A NAME="M14">WIDGET COMMAND</A></H3>
Supports the standard widget commands
<B>configure</B>, <B>cget</B>, <B>identify</B>, <B>instate</B>, and <B>state</B>;
see <I>ttk::widget(n)</I>.
<H3><A NAME="M15">STYLING OPTIONS</A></H3>
The class name for a <B>ttk::label</B> is <B>TLabel</B>.
<P>
Dynamic states: <B>disabled</B>, <B>readonly</B>.
<P>
<B>TLabel</B> styling options configurable with <B><A HREF="../TkCmd/ttk_style.htm">ttk::style</A></B>
are:
<P>
<B>-background</B> <I>color</I>
<BR>
<B>-compound</B> <I>compound</I>
<BR>
<B>-foreground</B> <I>color</I>
<BR>
<B>-font</B> <I>font</I>
<P>
Some options are only available for specific themes.
<P>
See the <B><A HREF="../TkCmd/ttk_style.htm">ttk::style</A></B> manual page for information on how to configure
ttk styles.
<H3><A NAME="M16">SEE ALSO</A></H3>
<B><A HREF="../TkCmd/ttk_widget.htm">ttk::widget</A></B>, <B><A HREF="../TkCmd/label.htm">label</A></B>
<div class="copy">Copyright &copy; 2004 Joe English
</div>
</BODY></HTML>
